CoPilot^ProTerm Extras 


The Copilot for ProTerm disk contains a subdirectory entitled 'EXTRAS*. 

Within this subdirectory you'll find three utility mods for the 
CoPilot/ProTerm scripts that you may want to use in your setup. These mods 
are entirely optional and should be added only if they provide a beneficial 
utility to you. You'll also find a stand alone ProTerm macro that may 
be useful in your GEnie use though it isn't directly used from within 
Copilot. 

1. NoMail - works with ProTerm 3.8 or 3.1 

NoMail is a simple addition to one of the ProTerm scripts that will allow 
you to bypass mail on any given call. If added to your setup* you'll be 
given the oportunity to hit a key* during each call to bypass mail on that 
particular call. This came into being to allow the scripts to continue if 
GEnie mail is unavailable. 

2. RT.LOGGER - works with ProTerm 3.8 or 3.1 

RT.Logger is a simple modification to the ProTerm scripts that keeps a log 
of what date/time you entered any GEnie RT. This is useful if you visit 
some RT s infrequently and want to check to make sure you get there within 
38 days so your message pointers aren't deleted by GEnie. Since this 
creates several log files that* if forgotten* could get large* it wasn't 
made an official part of the stock scripts. If you need it* the 
instructions for adding it to your system are provided. 

3. NickNames - works with ProTerm 3.1 _GNLY!_ 

Nicknames allows you to create nickname files for folks you send mail to 
often In addition* it allows you to create a short nickname for long 
INTERNET mail addresses so you don't have to type them in over and over and 
over and over.... : ) While CoPilot proper can now accept the long addresses 
in the primary mail address string it can't accept them in the CC 
addresses. This macro addition to CoPilot will allow you to easily include 
long addresses in both the primary addresses or any of the CC addresses. 
Remember* ProTerm 3.1 only! 

4. GooseKILL - works with ProTerm 3.1 _ONLY!_ 

GooseKi11 is a standalone ProTerm 3.1 macro. In short* it will call GEnie 
and get topic lists for the RT's that you specify. After logging off 
GEnie* you can go through these lists topic by topic IGNoring* UNlgnoring* 
MARking* LANcelling etc. You can then have it call GEnie again and send 
all your preferences. This macro gives you a liesurely way to kill those 
areas of no interest to you all at once* offline* for free.... : ) 

These were written by me* Bill Goosey CGG0SE3 in response to requests by 
clients over the last several months. All are currently in the A2 
libraries in one form or the other. Feel free to discuss them in Category 
29* Topic 15 of A2 
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in Phonebooks for each RoundTable/ etc 
add 
bee 


.. .. , _ ---- You will also probably want to 

Rou odTables for CoPilot to visit when you log on to GEnie. 
the Menu Descriptions section tor details of these and other choice 


ices. 


-feature ot CoPilot should be mentioned. When CoPilot is first 
Si 11 a yFomatically display the message file for the first 
RoundTable after closing the title window. If no such message file is 

you Mill be advised of that fact. If there is a message file which 
contains no actual messages/ you will also be advised. You can avoid the 
automatic search for a message file by holding down the Apple key while 
£ r n®? l P 9 * a ^ey or clicking the mouse to remove the title screen. When 
£8kil°** ls run a9ain the.same day/ the title screen is not displayed. At 
¥ OU 4 .£ an avoid the message file search by holding down the 
Apple key while the program is loading. 


a A?°u aut °w a ^ical ly load a message file when switchin 
different RoundTable. This can be avoided by holding down the Apple 
opening the RoundTables menu. (Note that you must press the key 
opening the menu. Holding it down after opening the menu but 
before selecting a RoundTable will not work.) 


Installation 

CoPilot should be automatically installed on your disk or hard drive using 
the Installer program. 


It is UERY important that none of.the script files that CoPilot uses be 
£ a £ a J?? d naming of the files is an important part of the logic of the 

?K2 9 r2p4 i a i so important that you do not MQvE any files/ or rename 

the CoPilot directories that the Installer creates. 

Talk is Cheap/ be sure that the Talk is Cheap program file 
Hawed '. If you have changed the name/ you will have to rename it TIC 
to ?E e C ate Properly If you are using a TransWarp GS at high 
c e +? Mre t J? at o y° U v/ haMe set T if?e Constant in the Talk is Cheap 

\° m ‘ -r£ ou ca ? 9 ?F to t\i ls setting by running Talk is Cheap 
*nd pressing Apple M. Then select item 9 and enter the correct number. 

ef a y?if II « re T y sin9 spectrum be sure that the Spectrum program file is named 
you have changed the name/ you will have to rename it 
* or CoPilot to operate properly You may also want to modify 
^2Ji«r,!3 ain o s S r Fo ^fl° u Manual access to the CoPilot scripts. See 
Appendix 2 for more information. 

lT^ yo V^ are u ? in9 ProTERM/ be sure that the ProTERM program file is named 
r!pi : i!£ 2 ou *"* ave changed the name/ you will have to rename it PT3 for 
CoPilot to operate properly. Be sure that the file PT3.System is also 
present/ as CoFilot uses tnis to actually run the PT3 program. 


necessary for you to understand your communications program's 
f^iEf<. 1 u,U?L! a ?S , ..S2 r 4.i s ltr ne cessary for you to understand how the CoPilot 
° usa £ he Prgsram However/ for those who want to know 
more about the scripts/ information is provided in Appendix 3. 


To run CoPil9 t From the Finder/ 
GECoPilot file is 1 


h the Finder, simply open the folder where the 
a stored and.double-click it. GECoPi lot is a normal S16 

selec?orf r such n as C ProS^i rUn ln conventional manner from a program 


“i?«..S on ^ ai P£ a X c 9 n .t}le for CoPilot which will provide you 
-Clouds i n ^0? sky Folder icon for a folder named CoPilot/ and 
rr^?~ ha ?* an lcon that will Present a little airplane for an ALIAS file named 
unu l can i r»-oaf o, a af i 9 vfe -® -l a Q d . ha |^ e . EasyMount installed (so that 

Hprnpfi nT f f • ls recommended that you make an Alias of the 

Finder) ' tile/ name it GEnie and drop it on the desktop (if you are using 


Menu Descriptions 


fl?.with all desktop interface programs/ CoPilot has several menus from 
which you can perform various functions. These are described below. 


File Menu 


On-Line Activity 


Thif item is the key to all of Copilot’s actions while accessing 
GEnie..The.choices made using the dialog control the actions your 
communications i program will perform while — your 

--—ts.of a list of the RoundTables 


p wuruvi y * VIIC V A VII2 

ie on-line. The dialos 


1 ls t,j 0 f the RoundTables presently set (using tfie 
°f the Setup menu) followed by a series of icons 
acce^ed*^ wba ^ action/ if any/ to perform uhen the RoundTable is 


hal C nnj n 8 0 ^ c ^f ou ?Kl ab i e D? Me * s a checkbox If a RoundTable name 
B as .J2?^? een se t/ the checkbox is dimmed and the icons for that 

C ?P no tt modified. If the RoundTable is named and the 

nof C th2 X piMrHTfH?t°r,?i? C K lwe ' lts status uil1 determine whether or 
not tne KoundTable will be acre«<eri the no»t time, 


w- -V 1 1 A /4 


T £r 


the checkbox is checked* the RoundTable will be accessed and the 
actions indicated by the icons will be performed. 


T £? e 4 .i cons in three columns. The first* labeled MSG* indicates 

whether or not CoPilot will yet messages from the RoundTable. The 
second column* labeled TRT* indicates whether there are messages 
>J? r £ ns t£y c £i° ns to ignore Categories or Topics) to be transmitted to 
the RoundTable and* it so* whether to send them during the next 
access. The third column* labeled OLD* indicates whether there are 
tiles.or descriptions of files to be downloaded from the RoundTable 
ana* if so* whether to download them during the next access. 


The key to the icons is : 


?ol i 
(oun 


le — Perform this activity during the next 
e access. 


Open apple --Delay this activity. Do not perform during the 
next RoundTable access 

Diamond — There is no activity to perform 

Clicking on an icon for a named RoundTable will bring up a dialog 
appropriate to the icon and permit modification if possible. The 
options vary depending on the nature of the possible activity. 

MSG icons Clicking on an apple icon will allow a change 
between receiving messages during the next RoundTable access 
and delaying the receiving of messages. It is not possible to 
have a diamond icon in the MSG column. 

TRT icons --.Clicking on an apple icon will allow a change 
between sending messages during the next RoundTable access 
and delaying the sendinc ' 
opportune " J ' * 
icon will 

diamond icon means that there are^no messages^to transmit. 
Message transmittal files are created using the items allowing 
creation of new or reply messages in the Message menu of Co- 
r 1 lot. 


fen senaing messages curing tne next Koundlable access 
Jelaying the sending of messages. It will also give you the 
"tunity to delete the transmit file. Clicking on a diamond 
will simply bring up a dialog reminding you that the 


messages. 


DLp icons Clicking on an apple icon will allow a change 
between downloading files during the next RoundTable access 

downloading of files. It will also give you the 
opportunity to modify or delete the list of files to be 
downloaded. Clicking on a diamond icon will bring up a dialog 
advising you that there are no files to download and giving you 
the opportunity to create a list of files. If you create 
or modify a list of files to be downloaded* a dialog will appear 
permitting the entry of up to ten files to be downloaded. You 
must enter either tne number of the file or the name of the 

y £ u *? nte r the name will be ignored. You must also 

indicate whether to.download the file (Did.) or just get its 
description (Descr.). Downloaded files wili be placed in the 
GEriles subdirectory of your disk (unless you have used the opti 
in the scripts to set your download directory elsewhere). 
Descriptions of files will be included with the RoundTabl 


on 


Le s 


version descriptions of downloads are also saved in 
the GEACU folder in a file named <RoundTable Name>.ACU 


**** BUG ALERT **** 


Jhere is a known bug in Copilot that sometimes causes the download 

no £ ^e noticed on the first attempt that you make to request it. 
The known workaround to this is (after making an entry in the download 
list) to click on the icon for the download descril 


;Al^ iny i on icon again* and this time choose "download next time". Of 
again* close the dialog box* and the download should proceed as expected, 
‘yperi^nce vhet ^his is in intermittent bug* and if you may never 



bu £ ton on the On-Line Activity dialog which provides 
a summary of the above information for your convenience Pressing 

t i v i t - ’ 


summary of the above information for 
Apple K will also select the On-Line Ac 


Lty dialog. 


Download 


b £ i Q 9 * up a dialog permitting the entry pf up 
♦ feSJ d ?KQi oa ^ d .fr o £!.. tb f^HT!:? n k? 0 HndTable. This is. 


yy * xw uc uuwiuudueu trow tne current K 

thl h s^ h Sifrbi r i2™^d f vis ff enter b ° th 


OLD apple in^the^On- 
jve>. You must enter 


■ihaf Kar f a 


download the tile <by clicking the radio button in the 
gr just M get its description <by clicking the r^diQ butt 
pescr. column). Pressing Apple 0 C<D>ownload) will al 
dialog. 


"Did." column) 
on in the 
so select this 


Load RoundTable Message 

Selecting this item will display the downloaded message file for the 
current RoundTable for reading. Pressing Apple M <<M>essage) will do 
the same thing. 

Load Message 

Selecting this item will bring up a standard file dialog box which 
will allow you to specify any file you choose to be loaded and 
searched tor messages. The messages can then be read in the same 
manner as tor the RoundTable message file. This item is primarily 
intended to be used to read archive files. Text files without 
messages can not be read. Pressing Apple L <<L>oad) will do the same 
thing 


ttt BUG ALERT **** 


in the current version. 


xperience an 
cannot be fixed 


Close 

i item Hi 11 close the top window. Pressing Apple 1*1 
«W>mdow) will do the same thing. 

Page Setup 

Selecting this item brings up a dialog box which allows the 
selection of paper size and other special effects to be used while 
printing. These settings only affect printing when using the Print 
item. 

Print 

If' for some reason, you want to use graphic printing rather than 
straight text printing, or you want multiple copies, you can set 
these options before printing by choosing this item. 

Draft Print 

Selecting this item wi 
screen) in draft mode 
correctly on printers 
that emulate it accura 
same thing. 

** BUG ALERT ** 

Actually this will probably NOT work on anything but an IraageWriter, but 
you are welcome to try it. 

On-Line & Return 

Selecting this item will cause you to exit Copilot, access GEnie 
using.your communications program, and return to Copilot when you 
are finished. If you changed the configuration during the session, it 
will automatically be saved. Pressing Apple G <<G>o) will do the 
same thing. 

On-Line & Quit 

Selecting this item will cause you to exit Copilot, access GEnie 
using your communications program, and return to your program 
selector when you are finished. If you changed the configuration 
✓ ?? S 5 10 P^ 1 ^ wi 11 automatical ly be saved. Pressing Apple U 

<U<u>it) will do the same thing. 

Quit 

Selecting this item will cause you to exit Copilot and return to 
your program selector. If you changed the configuration during the 
session, it will automatically be saved. Pressing Apple Q <<Q>uit) 
will do the same thing. 

Edit Menu 

Undo 

This item is not used by Copilot. It is present in case it is needed 
by New Desk Accessories. Pressing Apple 2 will do the same thing. 

Cut 

In the.word processor, selecting this item will copy selected text to 
the clipboard and delete it from the document. This item is also used 

nil crnmo Nau flwcL- Qrroccnr i ar i r,r, a V ■■<■11 M j-. .—. » 


11 print the current message <the one on the 
on your printer <Note : This has may not work 
other than the Apple ImageWriter II or printers 
tely). Pressing Apple P <<P>rint) will do the 


thing. 
Copy 


In the word processor or the message window, selecting this ite 
will copy selected text to the clipboard. This item is also use 


some New Desk Accessories. Pressing Apple C will do the same 
thing. 


used by 


Paste 


In the word processor, selecting this item will paste text from the 
clipboard into the document at the point where the cursor is located. 
This item is also used by some New Desk Accessories. Pressing 
Apple U will do the same thing. 


Clear 


In the word processor 
text. This item is al 


processor, selecting this item will delete any selected 
item is also used by some New Desk Accessories. Pressing 
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the Delete key or the Clear key (on the numeric keypad) will do the 
same thing. 


Select 


In the word processor or the message window, selec 
will select all text. Pressing Apple A will do the 


selecting this item 


same thing. 


Message Menu 


Read Next 


Selecting this item will advance to the next message in the 
currently loaded file. Pressing Apple > or pressing the space bar will 
do the same thing. In addition, as with most IlbS windows, clicking 
in the gray area ot the scroll bar will move the display one full 
screen. 


Read Previous 


Selecting this item will return to the previous message in the 
currently loaded file Pressing Apple < or pressing the "Tab” key will 
do the same thing. In addition, as with most IIGS windows, clicking 
in the gray area of the scroll bar will move the display one full 
screen. 


Next Topic 


item will advance to the next topic in the currently 
loaded file of RoundTable messages. Pressing Apple 0 <the number 
zero) will do the same thing. 


Read First 


Selecting this item will display the first message in the 
loaded file. Pressing Apple 1 will do the same thing. 


currently 


Read Last 


item will display the last message in the currently 
loaded file. Pressing Apple 9 will do the same thing. 


Find 


Selecting this item will bring up a dialog box which can be used to 


Selecting this item will bring up a 
find a string of characters in the 
in the string to be located and cli 
searched and the message containing 
string will appear with the string 
found, a notice of this will appear 
start the search from the presently 
message or from the start of the fi 
searcFi case sensitive. Pressing App 
thing Pressing only the F (or f) k. 
which the same string appears. 


i dialog box which can be used to 
currently loaded message file. Type 
ck OK . The messages will be 
i the next occurrence of the 
highlighted. If the string is not 
.tow can also select whether to 
displayed message, the next 
le and whether to make the 
le F <<F>ind) will do the same 
ey will find the next message in 


Write RT Reply 


fhl e rbrinsup a dialog box in which you specify 
the Category and Topic in which the message should appear When 

complete, clicking "OR" will call up the uord 

? ?pfDwCf^ W i?f? W H in 4 .K hlch iwrite your message. Pressing Apple 

r ^Kepl<y>) will do the same thing. 


Auto RT Reply 


wil1 call up the word processing window in 
thl * he 11 automatica 11 y fill in 

I 2£ currently displayed message. Pressing 

Hppie K t<K>eply) will do the same thing. 


GE Mail 


Selecting this item will call ud * HiaIoo k rw 


specify to whom you are sending the mail/ up to three people to get 
copies and the subject of the message..You can use the Phone Book to 
fill in the GE nail addresses by clicking the Phone Book button next 
to each of the entries. If this is selected while in Mail (that is* 
after selecting GE Mail from the RoundTables menu) and while a mail 
message is displayed/ the sender and subject of the displayed 
message will be filled in as the addressee and subject of the new 
message automatically by CoPilot. This makes it easy to reply to GE 
Mail messages. If you want to have different information in these 
boxes/ they can be easily changed while the dialog is displayed. When 
you click UK” CoPilot will display the word processing window in 
which you can type your reply. The message will be uploaded during 
your next GEnie session. Pressing Apple E (<E>lectronic mail) will do 
the same thing. 


++ Enhancement note... 

The Email editor has been enhanced so that you will be able to enter 
Internet addresses of up to about 56 characters. Additionally/ the “carbon 
copy boxes in the Email addressing module will allow you to enter TWO 
addresses/ separated by a comma/ so that you can send up to 6 carbon 
copies at a time if you choose. 

Sign 


Selecting this item will type a personalized signature (which is 
selected in the Setup menu) in the current message. Pressing Apple * 
(the tilde character — to the left of the space bar on a standard IIGS 
keyboard) will do the same thing. While this gives you considerable 

room 

for creativity in designing a signature/ you should be aware that 

ornate 

signatures tend to draw criticism from some people/ especially those 
who are 

paying long distance charges to access GEnie. 

Transmit 


Selecting this item will copy the message currently on the screen in 
the word processor window to the transmit file. Pressing Apple T 
(<T>ransmit) will do the same thing. 

Ignore Topic 

Selecting this item will insert commands into the transmit file 
telling GEnie to ignore all future messages in this Category and 
Topic. When this item is selected a dialog will appear asking you to 
confirm the request. Be sure to double check that the correct 
information appears in the dialog and that you really want to do this. 
If you accidentally tell GEnie to ignore a topic you are interested in/ 
you will miss all future messages in that topic. Pressing Apple I 
(<I>gnore) will do the same thing. 

Ignore Category 


Selecting this item will insert commands into the transmit file 
telling GEnie to ignore all future messages in this Category. When 
this item is selected a dialog will appear asking you to confirm the 
request. Be sure to double check that the correct information 
appears in the dialog and that you really want to do this. If you 
accidentally tell GEnie to ignore a category you are interested in/ 
you will miss all future messages in that category. 

++ ENHANCEMENT NOTICE ++ 


The new scripts_allow for much more control over the Ignore and Cancel 
functions than CoPilot itself gives you. Please read Appendix 5 for more 
detaiIs. 


Half Page 


When this item is selected/ the word processing window will be set 
to occupy the lower half of the screen allowing the current messag 
to be seen in the upper half. Pressing Apple H (<H>alf) will do th 
same thing. 


e 

e 


Full Page 


When this item is checked/ the 
to occupy the entire screen. P 


word processing window will be set 
ressing Apple J will do the same thing. 


Archive Menu 


Contained in this menu are the names of up to fourteen possible 
archive files to which the current message can be added for 
permanent reference. Selecting the appropriate description will add 
the current message to the corresponding file. A dialog box will 
appear to confirm that you really want the message saved in the 
specified file. You can turn off this dialog box from the CoPilot 
Options item in the Setup menu. If the archive file does not already 
exist/ CoPilot will create it for you. The descriptive names and 
corresponding filenames can be changed from the Archive Files item 
in the Setup menu. After archiving a message/ CoPilot will 
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the last message in a file, the same message will still be displayed 
after archiving. This feature can be turned off from the CoPilot 
Options item in the Setup menu. 

There is one additional item included in this menu called Unlisted. 
Selecting this item will bring up a dialog permitting entry of an 
archive filename to be used on a temporary basis. Messages can be 
added to the named archive file, but the archive will not appear in 
££ ,e 0 r chiye menu. Once.a name is set in this box, it will remain as 
the default temporary filename for the rest of the current session, 
unless changed again during the session. At the start of each session 
the file s default name is set to Temporary.Acv. The keyboard 
equivalent for this item is Apple + (or Apple = ), which can be thought 
of as Add an archive. 


*** BUG ALERT *** 

SOME users have experienced a problem with getting error messages when 
trying to archive files indicating that the specified archive file cannot be 
found, or does not exist, etc. Normally, this can be resolved by simply 
going to the Setup Menu, and selecting the Archive Prefix choice. Once the 
window opens, just click on OK, and things should work properly <until the 
next time the bug appears). 


RoundTable Menu 

This menu can contain up to eleven RoundTable names which are 
added $ from the Setup menu. Selecting one of the names changes Co- 
Pilot s configuration to handle messages from that RoundTable. If a 
word processing window is open when an attempt is made to change 
a RoundTable, a dialog box will appear to confirm that you really 
want to close the window. If a RoundTable message window is open 
when an attempt is made to change a RoundTable a dialog box will 
appear giving you the choice of saving the message file and marking 
your place in it for later reading, just saving it without marking it, 
deleting the message file, or canceling the RoundTable change. If you 
have changed the configuration while using a RoundTable, the new 
configuration will be saved before you leave that RoundTable. The 
RoundTable presently selected is identified by a check-mark next to 
its name in the menu. Its name also appears on the right side of the 
menu bar in large letters. Uhen changing to a new RoundTable for 
which no configuration file has been saved, most of the 
configuration information from the last RoundTable will be used to 
avoid the need to reenter configuration parameters that are likely to 
be the same from RoundTable to RoundTable. As usual, the 
configuration can be modified from the Setup menu and the new 

H b e saved when you exit that RoundTable or quit Co- 
Pilot. GE Mail is permanently installed as the last RoundTable choice. 

Setup Menu 

RoundTables 


Selecting this item will bring up a dialog box with buttons for 
eleven different RoundTables that can be used with CoPilot. Clic 
on the button you want to assign to a RoundTable or revise and a 
dialog will appear allowing you to configure that RoundTable. 
RoundTable 1 is the RoundTable that CoPilot uses when it starts. 


ck 

a new 


Enter the RoundTable name. The name can be up to 11 
characters long. If the RoundTable name is more than 11 
characters, enter a shortened version of the name. You must, 
however, make sure that no two names in your RoundTable list 
have exactly the same name. 


Enter the GEnie page number. This is the number of the GEnie 
page at which the RoundTable is located. Services on GEnie ar 


assigned page numbers. For example, the Apple II RoundTable 
main menu is located on page 645 and the Apple II Developers 
RoundTable is located on page 538. If you are not sure on which 


page the RoundTable you want to add is located, you can obtain 
a list by logging on to GEnie with your communications 
program and entering INDEX at the first GEnie prompt. Be sure 
you have turned capture’ on before you enter this command. 


To remove a RoundTable click on the "Delete RoundTable" 
button <Note : You can not delete RoundTable number 1 — 
although you can rename or reconfigure it — so no "Delete 1 
button appears for this RoundTable.) 


Clicking OK saves the confi 
RoundTable. It closes the con 
the RoundTable selection box. 
RoundTable changes, clicking 


gyration of the currently selected 
figuration dialog and reactivates 
M When you are finished with all 
will 


close this box. 


RoundTable Options 


ive. 
same 


as .the color selected in your control panel setting. To select 

different LOlor, simplu click fin f ha huffnn rrirrocnnr.H i nn 4- f Ka /-al a 


Q.I 


Books 


you choose. Your normal border color will be automatically restored 
when you leave Copilot. A black border will always be displayed 
around the title screen. 

Copilot Options 


Selecting this item brings up a dialog box which allows you to 
adjust the way Copilot operates in certain respects. 

If the first checkbox is checked; Copilot will automatically 
Place y 9 u r GE Mail address (entered in the Identification dialog 
of the Setup menu) in the first "cc" box in the GE Mail dialog. 
This makes it easy to always verify that your mail was 
uploaded properly by sending yourself a copy of mail you send. 

If the second checkbox is checked; Copilot will ask you to 
confirm your archive requests. This is useful since in selecting 
from up to fourteen items in a menu it is easy to click on the 
wrong item. A message improperly filed may never be found 
again This should be used at least until you have a feel for 
using this function. 


If the third checkbox is checked; CoPilot will start up using 
half page word^processor windows. If you find that you usually 
prefer to use full page windows; you can make that the startup 
condition by using this option. 


If the fourth checkbox is checked; CoPilot will automatically 
advance to the next message after archiving a message. Of 
course; if you archive the last message in a file; the same 
message will still be displayed after archiving. 


If the fifth checkbox is checked; CoPilot will permit use of 
certain keys on an extended keyboard for their standardized 
functions (this setting has no effect if you are not using an 
extended keyboard). The keys are* 


F2 

F3 

F4 

Del 

Home 

End 

Page Up 


Page Down 


Cut 



Delete character to the right 
Move to start of message 
Move to end of message 

Move to top of screen; or if already at 
top; scroll up one screen 
Move to bottom of screen; or if already 
at bottom; scroll down one screen 


allows you to adjust how long CoPilot notices 
will be displayed before automatically disappearing. (They can 
also be made to disappear immediately by pressing a key or 
clicking the mouse.) You can identify these notices by their 
blue text. 



the currently selected listin 


the Phone Book. 


Phone Book Listings 

. _ enter 
twenty 

_ saves 

does not close 
When. 

cl 1 eked to'sivi"11?“Note' also' that - 'iACH a RoundTabf| W <and^Mai 1 f b can 
have a seperate Phone Book; but that the default is to copy the phone 
book from one RT to the next. You can; however; alter this information 
for each RT. 


the.dialog box; so you can make multiple listing revisions. N 
finished; clicking Exit, will close the box. Note that; on e 
tfr? current selection; if any; is not saved -- "Save” must fi 


Archive Files 


belecting this item brings up a dialog box which allows you to input 
the filenames of up to fourteen archive files which CoPilot will 
create. You also can input a descriptive name for each archive which 
i in it he menu. The filenames follow the usual 

format. Click the mouse on the radio button of the archive you wish 
to change and enter the description and file name in the boxes at the 
bottom of the dialog box. The description for the first archive is 
p reset to CoPilot and its filename is set to CoPilot.Acv. You can 
change the description and filename for this archive but you can not 
tirst archive. You must have at least one archive 
identified Deleting an archive only removes it from the Archive 
menu --it does not delete the file. Clicking "Save" saves the 


currently selected archive. It does not close the dialog box; so you 
£?U« a f!L"K ltlp i e . revisions. When finished; clicking "Exit" will 
SAf S l-«^H box .*. c y ot ® that; on exiting the current selection; if any; 
not s<jved — have must first be clicked to save it. Like the “ 


any 
Phone 


is 


each RT can have its own list of Archive files. 


Archive Prefix 


this item brings up. a dialog box which asks you to input 

which CoPilot will create. The 


the prefix for the archive files 

prefix if.n he wnforcH in f he r.rtir 


1 n.-ii T-. . 


leading slash to indicate a volume name. The default prefix is 
9/GEAcv. Copilot sets the 1/ prefix (an internal prefix available in 
ProDOS 16 or GS/OS) to the pathname where Talk is Cheap or Point- 
to—Point is located.During the automatic installation process a 
subdirectory named GEAcv is created in this directory for storage of 
archive tiles. This works well on a hard drive. However you may 
prefer to have a separate subdirectory for each RoundTable or* 
especially if you are working from two floppies* you may want to 
store your archive files on a different disk. Use this item to set 
trungs up in your preferred manner. Like the Phone Books 
each RT can have its own Archive prefix. 

Signature 

Selecting this item will bring up a dialog box which will allow the 
entry of a personalized signature which can be added to the end of 
messages prepared using the word processor. The signature can 
include up to four lines* each of which can be up to 74 characters 
long. Like the Phone Books each RT can have its own signature. 

Communications 


Selecting this item brings up a dialog box which allows the entry of 
information control 1ing,the manner in which your communications 
program interacts with GEnie. You should enter the Telephone 
Number you use to dial GEnie* the Baud Rate your modem uses to call 
GEnie* whether you use a push-button <Tone> or dial <Pulse> 
telephone or need to specify a Special setup string to send to your 
modem and what^protocol you want to use for downloading files. You 
can also specify whether you want to automatically Unpack Binary II 
flles. 


The box for Prompt Character is hard coded to contain the 
character 


as the prompt. You can ignore this box. 




It is unlikely that you will need to use a special setup string. 
If you don t know about Hayes commands* just specify Tone or 
Pulse and in almost every case this will suffice. If you know 
you need a special string* or want to make some special 
settings to the modem like turning off the speaker* you can 
enter the commands here. 


It is strongly recommended that you download files with 
automatic unpacking. Most Apple Tl files are now processed 
with ShrinkIl. You can recognize them by their . BXY or .SHK 
extension. Unce you download them you will have to unpack, 
them using the bhrinklt program. Some files are still available 
m a form which has-been processed by BLU. These files 
generally have a BQY extension. Shrinklt can also process 
these files. Shrinklt is available in the GEnie A2 Library. 

Generally XMODEM IK will be the fastest method available for 
downloading from GEnie when using Talk is Cheap* but if you have 
line noise* you may get better results with regular 
XMUDEM When using ProTERM or Spectrum* ZMODEM is always the 
fastest method. While Ymodem is offered as a choice* Gtnies 
.. implementation of that protocol can best be described as 

problematic 

when used with TIC or Spectrum. Spectrum will NOT successfully 
download 

in Ymodem with these scripts* and the scripts themselves 
will default to Zmodem if you make that choice. 


In a similar fashion* 
if you choose Zmodem 
Zmodem protocol. 


.the TiC scripts will default to XMODEM IK 
in this dialog* since TIC does not support 


Identification 


Selecting this item brings up a dialog box which allows the entry of 
your GEnie user ID Number* your Password and your GE Mail address. 
This information is used when accessing GEnie. 


Enter your user ID number. Your ID was assigned when you 
requested your GEnie account. The user ID is a series of 8 
cha C3£'' e C s — three letters and five numbers* beginning with 
* n , ESC,-®xample* ‘XYZ12345" is a valid user ID* 

but XYZ12A45 is not. 


Enter your password. Your password was also assigned to you 
when you requested your GEnie account. Your password can be 
changed at any time (see your GEnie User Manual). 

- IMPORTANT NOTE - 


9 iMe your user ID Cwhich looks like 
XYZ12345 ) or password to anyone <not even while 
logged on t q GEnie).or use it in any message.on any part 
of the service. It is not required for anything other fch 

Your user ID is personal and 

am I avHaH f'nir l mi lir ir.+ * j — 


y IE is noE~require^ n ^< 

lodging on to the systew. V 
Driuat.P. Anri chmilH ha caPi 


an 


GEnie will never ask you for your user ID 
you are on-line. If you receive any type of on-line 
etrom.anyone requesting your user Ip, ignore it 
11 GEnie Client Services at 1-800-638-9636 to 
this occurrence. GEnie Client Services personnel 
y ask you for your user ID, but only when you actually 
II.a GEnie representative on the toll-free customer 


protection 
whi le 
message 

and cal _ _ 

report this occurrence 
rna 

ca _ ___ 

service telephone number. 


Enter your mail address. Your GE Mail address is the series of 
13 characters or less you selected when you requested your 
GEnie account. 


Choose Font 


^electing this item brings up a dialog box which allows you to 
change the font in the word processor. You may want to use this 
function to change text copied from the clipboard to CoPilot.8, so 
that you can see how it will look when transmitted to GEnie. 


Word Processor 

The word processor is used to create messages which can be uploaded to 
GEnie using your telecommunications program. It features a rich variety of 
editing functions, including; 

Positioning the cursor using the mouse. 

Moving the cursor with the left and right arrow keys. 

Moving the cursor one word at a time using the Option key with the 
arrow keys. 

Moving the cursor to the beginning or end of the line using the Apple 
key with the arrow keys. 

Selecting text by clicking and dragging the mouse. 

Selecting text by using the Shift key with the arrow keys. 

Selecting a word by double-clicking the mouse. 

Selecting a word using the Shift and Option keys with the arrow 
keys. 


Selecting the whole line by triple-clicking the mouse. 



Extending or shortening the selected text by clicking the mouse 
while holding down the Shift key. 

Using the delete key to remove the preceding character. 

Deleting the next character using Control-F. 

Deleting the line using Control-X. 


Deleting the line after the cursor using Control-Y. 

Simply type the document so it appears on the screen as you want, and it 
will go to GEnie in the same format. There is one exception. GEnie assumes 
that an asterisk it> in the first column indicates a command. Therefore, 
you should avoid typing an asterisk in column one. If you forget and do this 
anyway, LoPilot will insert a space before the asterisk to move it to the 
second column. In some cases this may cause the last word in the line to 
wrap to the next line when the message is uploaded, slightly changing the 
forwatting. 


Special Functions 

A£,£ oPilot S? oes no ^ Perform an activity on GEnie that you want, you can 

custom script which . LoPi lot will, execute after it has finished its 
activities, but before signing off from GEnie. (See Appendix 3 for details 
h special menu is available while on-line or before going on-line which 
allows you to quickly set up and automate a number of commonly used 
functions. (oee the script documentation for specifics regarding this 
menu, and what you can do from it.) 


The menu can be called up whenever you see the notices given by the 
t?i ** ^ipts. These notices appear before accessing each RT, and when 
fi-requested activities are complete or when the activities are 
aborted because of some difficulty. 


In normal 
will have 


operation, you will see the following notices, in each case, you 
5 seconds to press a key in order to access the CoPilot Menu. 


Before Copilot actually dials GEnie, you will see this message... 

"Preparing to go GnLine with CoPilot, press any key to see the CoPilot 
Menu 



Before accessing a RoundTable/ Copilot will say 

"GnLine with GEnie Copilot/ press any key to see the Copilot Menu" 
Before signing off GEnie/ Copilot will say... 

“Preparing to terminate session — Press a key to continue on GEnie" 


If the script aborts prematurely/ due to a GEnie error/ you Mill see this 
notice s 

„ A ERROR ENCOUNTERED — ABORT SEQUENCE INITIATED 

Preparing to terminate session — Press a key to continue on GEnie 


NOTE : If you have stopped script operation for some reason (perhaps to 
attend a Real Time Conference)/ you can access still access the menu. (And 
from the menu/ you can restart script operation. A special script has been 
included with the other script files uhich does nothing but call up the 
menu. The name of that script is "menu". 

ProTerm users.... Hit Option M to run the "menu" script. 


TIC.users... hit Open Apple X/ uhich Mill bring up a dialog asking you uhich 
script you .want to run. bimply type in MENU and hit return. (It is 
recommended that you add this script to your TIC.MACROS file for ease of 
* ? e 5 Appendix 5 for detai Is on how to do this. We deliberately 
did NUT include a TIc.MACRuS file containing this setup in the installation 
program because ue did not want to overwrite any TIC.MACROS you might 
already have set up.) 


Spectrum users... under the SCRIPTS menu/ choose "Run a script"/ and/ from 
the dialog box, choose the menu" file. 


(It is recommended that you add this script to your Spectrum.Menu file for 
ease of operation. See Appendix 4 for details on how to do this. We 
deliberately did NOT include a Spectrum.Menu file containing this setup in 
the installation program because ue did not want to overwrite any 
Spectrum.Menu you might already have set up.) 

Errors 


Copilot has fairly complete error trapping built in. Typical errors/ such as 
trying to access a file on a disk uhich is not present or trying to write to 
a disk which is wr 1 te-protected/ will bring up a dialog box. The dialog 
advises that a problem has occurred/ offers a choice of canceling the 
request which precipitated the error or trying again (presumably after you 
have loaded the disk/ etc.)/ and provides the GS/OS error code. For the 
more common errors/ the dialog box also gives a brief description of the 
nature of the error. The error code is given in hexadecimal/ which is the 
way tables of these codes are usually organized. Such tables can be found 
ications. Gary Little's excellent book “Exploring the Apple 
IIGS (Addison-Wesley Publishing Company) has such a table in chapter 18. 

The dialog also includes a "location #“. If you get an error uhich you can 
not understand/ provide a description of what you were doing (in as much 
detail as possible)/ the error code and the location number to the Copilot 
support topic in A2/ Category 18/ Topic 11. 


Appendix 1 

Spectrum Installation 


When Copilot is installed on Spectrum/ and you tell Copilot to go online 
via Spectrum for the FIRST time/ you may (almost certainly WILL) be 
presented with a dialog box asking you for the "file to pass". Simply select 

^he file GECOPILOT.S.TTL via the dialog box. This setting will be 

remembered/ and you will not see this message again UNLESS you move the 
Copilot folder to another location. If you do move it, you may (or may not) 
v ee dialog again/ and again/ just feed it that file and all will be well 

You MAY also be asked which application to start the first time you try to 

go online. If that happens/ simply choose the Spectrum application. 


ProTerm Installation 


ProTERM 3.8 has a pathname length limitation of about 32 characters. 

that.CoPl1ot uses up about 24 of these/ it is 
IMPuRTANT that ProTERM 3.8 users install Copilot only one subdirectory 
deep in a volume directory. ProTERM 3.1 has 64 characters but it is 
recommended that they adhere to the one level deep rule also. 


The*file in the ProTERM subdirectory in which you install 

Sii 1 RECL0CEO. dur ing .insta 11atl?n by one intended, to insure, 
operation of LoPilot. Since we don z want to overwrite any custom 
GLOBAL file you may have created ue STRONGLY recommend that you 
Create a totally NEW and SEPARATE PrnTFPM cuhrli rorfr.ru 1 rif»-» uhi rh iir.ii 


. ...TREC recommends be 
<See your Manual;. 


will install CoPilot. Keep your existing ProTERM setup as is for non GEnie 
calls. Make sure that PT3.SYSTEM is in this MEW and SEPARATE 
subdirectory along w*th 3 II the other files that INTF~ 
present in a hard drive installation of ProTERn < 

A second and equally important reason for installing CoPilot in a NEW and 
SEPARATE ProTERM subdirectory is Memory. ProTERM allocates a block of 
memory for competitive use by your GLOBAL file, emulations, dial data, 
and the scripts themselves. This block of memory is of fixed size 
regardless of how much memory you have in your GS. ProTERM 3.0 has less 
memory available than ProTERM 3.1. By using a NEW and SEPARATE 
subdirectory for CoPilot, you * 11 ensure that you don’t run into "not enough 
memory problems caused by emulations, dial lists, etc that you may have 
already set up that may chew up memory that the scripts NEED for 
execution. 


TIC Installation 

TIC installation is so simple that no special instructions are needed. See 
appendix 4 for directions on how to set up a “hot key" to allow calling the 
CoPilot menu. 


Appendix 2 
CoPilot Scripts 

CoPilot controls the on-line activities of your communications program 
through a series of scripts and a series of text files created by the 
CoPilot program according to what you want to do in each session. It is 
not necessary for you to understand the script language to use CoPilot, nor 
is it necessary for you to understand how the CoPilot scripts work to use 
the program. However, for those who want to understand what is going on, 
the following information will help in gaining an understanding of what 
the scripts do. You should refer to your program’s documentation for an 
explanation of its script language. 


The standard scripts <i.e. those which come with the program and are 
never Modified) are essentially the same for TIC, Spectrum and ProTerm. 

For instance, the script GECOPlLOT.M.ABT is the “abort” script for 
ProTerm. The Spectrum version is GECOPlLOT.S.ABT, and the TIC version 
is GECOPlLOT.T.ABT. While the script commands in each of these files is 
slightly different, the functions they perform are identical. These scripts 
are listed here with only the suffix to save space. <In each case, the full 
name of the script is GECOPlLOT.x.name, where the x indicates which 
communications program it is intended to work with.) 


.ABT <- 

encountered 

.ACT <- 

.AC2 <- 

ProTerm 

.CON <- 

.EX <- 

needed 

.MAL <- 

.MA2 <- 

ProTerm 

.MNU <- 

run <- 

.TTL <- 

running 
.UAR <- 


the "abort" script, bails out and logs off if an error is 

the main "action" script, performs RT activities 

this is a continuation of the "action” script, used only for 

the script that actually logs on to GEnie 

the script that logs you off, also calls any special actions 

the "mail” script that performs all mail activity 

this is a continuation of the "mail” script, used only for 

this is the CoPilot Menu script 

this is the script that dials GEnie and makes the connection 
this is the "startup” script that simply starts the others 

this is the script that reads your phone # and password info 


The following are the "special” scripts that are called from or 
manipulated by the CoPilot Menu script. 


.A2BPS 
.A2D0M 
.GETBILL 
.PROLAMP 
.SPL.1 
.SPL.2 
.SPL.3 
.SPL.4 
.SPL.5 
.SPL.6 
.SPL.7 
.SPL.8 
5,6 and 7 
.SPL.L 
.SPL.R. 
.TWGLAMP 



retrieves the A2 Pro Blue Plate Special file 
retrieves the A2 Disk of the Month 
retrieves your GEnie Bill 
retrieves the A2Pro GEnie Lamp 
sets up a library search 
message search 


sets up 
sets up 


library uploads 


sets up Xmodem mail uploads 
sets up "one time actions” 
sets up CoPilot preferences 
sets up RoundTable preferences 
checks, and allows you to reset. 


all items set by 


< - sets up a delayed logon 

< - retrieves Xmodem mail semiautomatically 

< - retrieves the A2 GEnie Lamp 


There are several text files which will be created by the CoPilot program 
itself depending on the activities required. These are 



<RoundTable name).Msg 
<RoundTable name >.Trt 
<RoundTable name>.Did 


b |koPilot.RT is the key to the nature of the session. It contains the names 
of the RoundTables to be accessed and a list of the activities to be 
p £^f orme< ^ i n ea £h RoundTable. You Mill see that at the beginning of the 
.Oil script a check is made to see if the GECoPilot.RT file is present — if 
it is not, the script aborts. 


The structure of a typical GECoPilot.RT file is as follows- 



ME 


2E 

ro 


The meaning is : 


Line 1 — Name of RoundTable to be accessed. 


used 


Line 2 -- GEnie page number of RoundTable to be accessed <must be a 
number which you can use with a GEnie Move command). 

Line 3 -- This is a series of letters indicating which activities to 
allow. The meanings of the letters are : 


M 

T 

D1 

D2 

D3 

E 


— read messages 

— transmit messages 

— download files using XMODEM 

— download files using IK XMODEM 
—download files using YMODEM 

— transmit GE Mail messages <- 


note* this function is not 


from this location with the 
current scripts. 

If the letter is presents then the action will be attempted. Note that 
a II except M, if a corresponding file is not presents the action 
will also be skipped. This double checking is present to allow you to 
set up, for example, a download file, but defer the downloading until 
a later access. 


Line 4 -- The whole sequence starts all over again here. It can be 
repeated as many time as you like to access as many RoundTables as 
desired as long as each RoundTable has three lines in the sequence 
shown. 


The <RoundTable name).Msg file is the one Copilot creates when it 
downloads messages from bEnie. The name for each RoundTable messa 
tile is made by appending Msg to the RoundTable name. So for 
RoundTable it would be ftS.Msg. The GE Mail file is Mail.Msg. 


age 

tne 


A2 


The <.RoundTable name>.Trt tiles are the message upload files created by 
"t 1 !" l name for each RoundTable upload file is made by appending 

• Trt t?. the RoundTable name. So for the A2 RoundTable it would be 
A2.Trt. The GE Mail file is Mail.Trt. 


file is more interesting. Its name is similarly constructed 
by appending .Did to the RoundTable name. Its structure is typically as 
toilows : 


1001 

A2.1001 


Line 1 — This line contains the file number or name. 


in 

is 


Line 2 —.This line contains a nawe to be used when the downloaded 
file is stored on your disk. The name is constructed from the name 
iine A j ii n e 1 contains a file number, the file number 

appended to the RoundTable name <with a period between). If line 1 
contains a name, the name is used except that a maximum of the 

te<en characters are used and characters not acceptable to 
ProDOS (like a space) are changed to periods. Note that if a file has 
in Binary II format (as most Apple il files are currently) 
and Automatic Binary II unpacking is enabled <from the 
Lommunications dialog of the Setup menu) this name will be ignored 
and the actual tile name will be used. If this line contains an 

£ a £t? er ^i* an a f 1 !? name, CoPilot will only download a 
description of the file, not the file itself. 


Line 3 — The sequence repeats as many times as you like. 


The v2.5 script for CoPilot also create a number of text files. Some of 
these tiles.are. flags", files which contain no data, but whose EXISTENCE 



change your prefernces via one of the configuration scripts. The 
files are as follows 


‘flag* 



z.twolamp 
z .prolamp 
z. A^dom 
z.a2probps 
z.bi11 
do.xmai1 
RAli ALL 

CRoundTable name).RAM 
specific RT 


<— get A<d GEnie Lamp 
<—get A2pro GEnie Lamp, „ J 

<— get A2 Disk of the month 

<— get A2Pro Blue Plate Special 

<— get GEnie Bill 

$— default to automatically retrieve Xmodem mail 
<— default to RAM instead of BROwse for all RTs 

<— default to RAM instead of BROwse for 


The following tlies serve as data files AND flag files. That is, they not 
only tell the action script that there is something that needs to Be done, 
but also contain the information the action script needs to DO whatever 
that task is. 


date.check 
Xmai1.TRT 
DLD.PFX 
Mail.PFX 

<RoundTable name) 
<RoundTable name) 
<RoundTable name>. 
<RoundTable name>. 
<RoundTable name) 
<RoundTable name> 
topics 

<RoundTable name> 
specific messages 
<RoundTable name > 
the library 
<RoundTable name> 
upload where 
CRoundTable name), 
download to 


<-- 

<— transmit 
<-- 


IND 

TOP 

NAM 

1GN 

CAN 

MARK 

MsgSrch 

LSRC 

upldat 

PFX 


< — 
<-- 
<-- 
<-- 
<-- 
<-- 

<-- 

< — 

< — 

<-- 


default to checking for "new files" once a day 
Xmodem Email 

contains “global" download prefix 
contains specific prefix for Xmail downloads 
tells the .ALT script to get an Index 

tells the .ACT script to get a topic list 

tells the .ACT script to set a "nickname" 

tells the .ACT script to ignore set topics 

tells the .ACT script to cancel set topics 

tells the .ACT script to mark specific 

tells the .ACT script to search for 

tells the .ACT script to keyword search 

tells the .ACT script to what files to 

tells the .ACT script to what prefix to 


Certain other files are.also created by the scripts. These files record 
information from GEnie.in special cases. These files will ALWAYS be 
saved in the GEFILES directory. 


GEnie.BILL 

<RoundTable name).Index 
is it 

<RoundTable name).TOP 
<RoundTable name). RTC 
be captured 


<— when you get your bill, it is saved in this file 
<— if you do an Index for a RoundTable, this 

<— and if you get a Topic List, THIS is it 
<— if you join an RTC via the scripts, it will 

to this file 


Xmail.Record 
Port.Data 


. . A <•— records Xmail upload transactions 

<— if you are running the special “port" script, this 

file contains the port data <that script is an 
extra" and you will know if you are running it) 


Both of these last two files will continue to grow, and there is no 
mechanism to control their size. You will want to purge them once in 
while, just to keep them from getting too big. 


a 


Final li 


_ the mail and action scripts will copy/rename the transmit 
^lies for mail and any RT you send messages in. whenever you send mail, 
your MAIL.TRT file will be renamed MAIL.TRT.OLD after it is sent. This will 
allow you to retrieve copies of the mail you sent any time UNTIL you send 
more mail, at which time the file will be replaced with the latest "old" 
When transmitting mail, the mail script captures the messages 
from GEnie acknowledging the transmission as part of your MAIL.MSG file. 

A quick glance at this capture will tell you if a particular letter was not 
transmitted for some reason <such as a typo in the address) and you can 
then recover the mis-sent letter from the "old mail" file instead of having 
to rewrite it. 


I n same fashion, the individual transmit files for each RT are renamed 

to <RoundTable Name).TRT.OLD after being sent. What use you make of 
these files is up to you. 


Appendix 3 
Special Functions 


As part of its normal sign-off process. Copilot checks for a specia_ 
in the GEFiles subdirectory called GECoPilot.Spl. If none is found, it 
continues on and signs off. However, if such a script is found CoPilot 
chains to that script and executes it. <See the .EX script to see just when 
this activity occurs.) The script will begin execution at the prompt of the 
last RoundTable accessed by CoPilot. <Note that if you wish to perform 
actions in a different RoundTable — even in one which you visited earlier 
in 5T ,e same session — it will be necessary to transmit a Move command 
as the first action of your special script.) 


.CoPilot checks for.a special.script 


Tn Arldi f.i nn f fl tho cnor i l 1 err i nf CCT’rvP'ilr.4- Cnl 
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complete menu of custom scripts which can be called from the Copilot 
menu. In the Copilot Menu* choose "Quit Options"* one of the options is 
6° P enu • This^option* when chosen* will call a script named 

x.USERMENU * where the x is either an S* T* or M* depending on which 
comm program you are using. <The usermenu script must reside in the 
same directory as the menu script* i.e. GEFILES). 


For information on writing scripts see your communications program’s 
manual . 


" 4 . 


Appendix 4 

Calling the Copilot Menu 


From Spectrum 


f)f*u 1 o cus ? ed a £ove* you can call the CoPilot menu when in terminal mode 
with Spectrum by^choosing Run a script" from the SCRIPTS menu and 

* n9 4 . on ^he tile name.d menu.. A much more satisfactory way to do 
Ka. 1 .! if «2r^ e ^i up 3 key which will run within Spectrum. Assuming you 

have no menu already set up* the way to do that is as follows. 


In the GECQPILQT.S.TTL script* add this line at the beginning 
load raenufile $spectrumpathspectrum.menu 


Then create a text file* 
Spectrum. That text file 


named SPECTRUM.MENU in the same directory as 
should contain the following line... 


M CoPilot Menu 


Then simply copy the^"menu" file included with CoPilot into the same 

^ • SPECTRUM.MENU* rename the file as M. Now* when you run 
scripts* under the SCRIPTS menu* you will find a choice named 

CoPilot Menu. You will also be able to call the . 

hitting Gption-M on the keyboard. 


^e menu directly by simply 


From TIC 


you c ! n the CoPilot menu when in terminal mode 

with Tit by hitting Upen Apple X and typing in the name MENU followed by 
key*. A much more satisfactory way to do this is to set up a 
m-acro key which will run within TIC. Assuming you have no macro 
already set up* the way to do that is as follows. 


Create a text file named TIC.MACROS in the TIC directory. This file must 
contain the line 


mCoPilot Menu 


ID^D-? 1Mply c PP y T^rf Menu file included with CoPilot into the same 
directory as the TIC* rename the file as TIC.KEY.M. Now* you will be able 
to call the menu directly by simply hitting "Option-M" on the keyboard. 

Note that the instructions given here for both TIC and Spectrum assume 
that you are not already using this function with your current setup. If you 
DU have a Spectrum Menu or a TIC MACROS file* then you can fit this 
function in anywhere you like* there is no need to use the letter M if you 
are already using it for something else. 

From ProTerm 

P|T oT § r w installetion includes a new PT3.Global file which has already 
Du * " e .°Ptign-M choice added to it. No extra work is needed. The reason 
that we included this with ProTerm and not with TIC or Spectrum is that 
we recommend that when CoPilot is used with ProTerm that a dedicated 
ProTerm folder be created for use ONLY with CoPilot. Thus* modifying the 

^ lle ,relatively harmless Since it is anticipated that TIC and 
Spectrum users will be installing CoPilot on a folder that is also being 
used for other services* we expect that many users will already have 
created their own TIC.MACROS or SPECTRUM.MENU files* and will not 
appreciate having them overwritten by our file 


Appendix 5 

Added functions provided by the new scripts 


The following activities can be set up while off line* and the process will 
be automated when you go on line. 


1 . 

2 . 

3. 

4. 

5. 

6 . 


Library uploads. 

Xmodem mail uploads. 

Library searches. 

Messages searches <by date* author* 
Set a nickname in a RoundTable. 

Set up extensive lists of topics and 
cancelled. 

7. Set up extendi up 1 i cf.c nf f nc.i r--c f.n K 


topic* message 
categories to 




number* etc), 
be ignored or 







8. Retrieve an Index of a RoundTable. 

Retrieve a Tonic List of a RoundTable. 
retrieve the 62 Disk,of the Month.. , 

Retrieve the A2Pro Blue Plate Special. 

Retrieve the A2 edition of GEnie Lamp. 

13. Retrieve the A2Pro edition of GEnie Lamp. 

14. Retrieve your GEnie Bill. 

15. Check libraries for new uploads on a daily basis. 

The following preferences can be set up for CoPilots online operations. 

16. Choose to do a RAM or a BROwse in any RT or all RTs. 

tP oose automatically download Xmodem Email if it is waiting. 

}§• £D oose a special pref'ix/f older for downloads from any or all Rfs. 
ly. Choose a special prefix/folder for Xmail downloads. 


Additional “hidden* 


features of the new scripts. 

.1-1* set up an RT named "SPECIAL", the main action script will branch 

g T ^ u f tom script you have wr i tten. . This RT MUST come last in your list 



is for, S 

same as using a . SPL script as described ln^AppenSix"^!*The"difference S is he 
^Kf^K you can fhoose.whether or not this script will execute by choosing 
whether or not to visit the Special RT in the Online Activities menu. 

2 The mail and RT transmit files.are saved with the suffix of .OLD after 
they are sent Vas described aboveJ* allowing you to recover them for 
whatever reason you may have to do so. 

.The new scripts deal more gracefully with GEnie errors where an 
ifi.irHiri ■ * -P Emails is down for maintenance or due to some problem. 

HyWfcvfcK, since GEnie programmers enter the error messages manually 
when such conditions occur, these error trapping routines will sometimes 
f 2 l l' i.u e to someone entering a prompt in a slightly different fashion than 
what the scripts expect. 

i^ ? er, t before any reply files are transmitted. This will, 
hopefully, eliminate some instances of failure to post replies due to line 
“ncPctcn" ,e control X.clears the "current line” ana GEnie generates a 
DELETED message to indicate the line is clear.) This will not help in 
c f se ? of really noisy lines, but should relieve some problems in the face 
of mild line noise. 

The scripts, when waiting for the "EXIt, or HELp” message from GEnie 
vindicating the end of message reading) now include a a M in the waitfor 
f2r r 2 n9 ' which should help avoid errors due to people inadvertently posting 
that prompt as part of a message. 

6. The main action script no longer deletes the GECOPILOT.RT file at the 

1 $ S °P era ^ lon - This means that.you can, if you wish, go online with 
cow !2 P r 99 ra G without first, going into CoPilot and setting 
nn? perform^ Note that in this case, the actions that will be 
performed will always be those that you performed LAST time you were on 
l ine. 

CoPilot to dial an alternate phone number (or numbers) 
?°2 e D u, 9ber is busy or out of order, you can do this be 
Srif? t K2 9 ^f«.IS e rruTir t ^? < ^ til® and putting it in your GEFILES folder. The file 
must be named GENIE. ALT. DIAL, and it must be formatted as follous. 

Baud rate 
phone number 
baud rate 
phone number 
baud rate 
phone number 

END <-if you don’t put this at the end of the file, ugly things will 

happen 

? a P py £i a ^ Mfny different numbers as you want in this file, and 

JUS * *eep on dialing until.it runs out. You will be presented 
with the option.to discontinue this activity after each failed connection. 

If you are running an automated session <i.e. if you aren’t there to stop it, 
this sequence WILL run, so be sure that you don’t have any long distance or 
surcharged numbers in this file unless you are prepared to have the thing 
use them .> 

Appendix 6 

Using the new scripts and the CoPilot Menu 

a ? rea ^ deal of effort has.gone into making the new scripts 
explain themselves when you run them, (in several cases, actually 
replicating the GEnie prompts), this section will NOT contain step by step 
information on using the scripts. Instead, this section will simply 
describe what each item on the CoPilot Menu allows you to do. 


CoPilot Off Line Menu 





GEnie ? but you get to do it OFF line* at your convenience* without the 
♦ticking clock* of the GEnie bill. Once you go online* the actions you 
25 b f.P er torHed by the Copilot scripts* much wore quickly tha 

you could do them yourself. Additionally* items on this menu allow wo 


y°y F.2 u i d do th f m yourself. Additionally* items on this menu allow you to 
set.up some preferences in the way that the UoPilot scripts operate. The 
choices we have Made available are those that were requested By our 
users. Things that are not implemented on these menus* and in the scripts 
themselves* are things that* almost.without exception* COULD NOT be 

® ljwitations inherent in scripted operations or 
because of limitations of the GEnie software 


itself. 


.. 1 ? library search... presents you with the same prompts that 
XJJH you doin 9 £ library search live. You enter things as 

you would on line* and the scripts then perform your search when you get 
on line. 

a f? e f sa 9 e search.. asks questions about what messages 
want to search tor* and saves the answers in a format that allows the 
+ k 00 a message search for you. Note that this has nothing 

to do with reading new messages (i.e. there is no need to do any setup h^re 
m ^ a9 £ reading)* but allows you to search for old 
numbers S ^£ c speci * lc ar,d Tops* by date* author* a range of message 

-^+r?« u E^Mj? rary uploads... Once again* this function allows you to 
S?? ke ®htrles as if you were live on line and uploading a file* but WITHOUT 

ahout t TL.n 1 ?? 0 «i OC fL IDS a £ tlon scripts perform the upload for you. Like the 

script prompts you for the information it needs in 

does ' 50 not much explanation is needed here*, 
however there are a tew things you should pay special attention to... 


0. You simply CANNOT use quote marks 


description. The 


be perfectly understandable* if grammatically incorrect. 

The files you intend to upload MUST be. in the GEFILES subdirectory 


e. If they are not* tl 
the script will break 


les you intend to upload MUST be in the GEFILES subdirectory 
at the time that you go online with GEnie. If they are not* th< 
ugly things will happen (Specifically* the script will break 
with an error that cannot be recovered by the script. You will 
unuiTMirD^® llb r?»ry GEnie kicks you off for inactivity. 

HuWEUER* you will* at that point* be in "free upload" mode* so 
this should not incur any charges to your account.) 


HGWEUER* 
this shou 


4 will* at that p 
not incur any ch 


oint* be in "free uploa< 
arges to your account.) 


C. It you start to prepare uploads* and* for one reason or another have 
to quit and come back to the routine at a later time* you will 
be presented* by the scripts* with the option to delete the 
upload descriptions and upload data that you have previously 
entered. This is particularly useful if you are halfway through 
the process of preparing uploads and have to break the script 
tor some reason. 

Hem iZ Set up Xwodew Email- Allows you to set up Email file transfers* 
. J .Ji» t *i h 54.? ay K he ! 1 2& rar S u Pl° ad script does. This function does NOT allow 
you to attach a letter to the upload. That must be done within the Copilot 
H?^? dltor H ltseif * A 9am* the files to be uploaded MUST be in the GEFILES 
directory when you go on line. 

Item 5- Set up special actions- Takes you to the special action menu* see 
below. 

up Copilot preferences- Takes you to the preferences menu* 

see below. 

Item 7- Set up Roundtables- Takes you to the Roundtable setup menu* see 
below. 

?7 Check/reset all actions- Takes you to a script that will display* 
delete or reset* as appropriate* EUERY SINGLE ONE of the 
92 - ®rs and actions that can be established using the CoPilot scripts. 

-i? a bit tedious to run if you have a LOT of stuff set up* but you 

will find it to be a convenience* nevertheless. 


CoPilot Action Menu 

rPr he C e are meant to be used WHILE you are on line with 
GEnie. Items with a t can be used both on and off Tine. 

J Item A- Reset CoPilot Actions- This script REQUIRES that you know bot 


the pa ge number of any RT you want to visi?* but also 
that you have given that RT in your CoPilot RTs list, 
need to use this function* but if you break out of the 
on this later) and want to restart the Copilot action 
revisiting any of the RTs you have already visited in 
then you need to use this function to do it. Also* if 
instance* a.library search* and you have neglected to 
went b *?e KT that you have set up the search i 

will NuT be performed until you actually visit the RT 
particular menu item allows you to adjust that sort of 
back to LoPilot. 


that you know both 
the ExACT spelling 
You will not normally 
scripts on line (more 
script WITHOUT 
the current session* 
you set up * for 
tell CoPilot that you 
n* then the search 
involved. This 
thing without going 


launches the Copilot Action script, the one that does all the work on 
GEnie. 


Item C- Join a Real Time Conference- If you are online, this will allow you 
to qoin a RTC. It presents a menu that allows you to 90 to the A2 or A2Pro 
conference areas, or, if you want to 90 somewhere else, allows you to 
en 5 e r i . th ^-rP aw ^, f n d page number of the RT. The buffer will be turned on, 
and the RTC will be saved as a file in GEFILES named <RoundTable name>. 

RTC You will automatically be placed m CHAT mode at the appropriate 
moment, and you will be allowed to enter a nickname if you choose. 

Item D- Dial or Redial GEnie- ALL this does is start up the script that 
dials GEnie. You can#t use it while you are on line, iz is for restarting the 
dialing process after working with the other menus. 

Item L- Set up a delayed logon- Allows you to enter the time that you 
want a GEnie session to be run Jhe scripts will wait until the GS clock 
reac hes that time, then dial GEnie and perform the scripted actions. 

Retrieve Xmodem mail- Takes you to the GEnie Mail area and lists 
3 1 * f 1 *?; 5 you .have waiting, allows you to choose which file you 
^K?Si-^ and *. d ? wn i oads « lt X 0f l yo ¥- This option is provided for those who 
choose not to have Xmail downloaded automatically, or who choose not to 
download it at the time it comes in. 

T ” Te £ 5 ina l mode- stops all script operation and leaves you 

live on bEnie : <See Appendix 4 for details on getting back into the menu 
from this choice.) 


NOTE; The ProTerm scripts operate slightly differently at this point. 

Instead of a choice to go to Terminal mode, the ProTerm scripts have a 
choice here to take you to a help menu that will allow you to read these 
docs and several other help files. <To read the docs from that menu, you 
must copy them into the GEFILEb folder.) This menu also allows you to 
view several other files, if they exist, such as an RT Index. This feature 
depends on a particularly nice feature of ProTerm which displays text 
files a page at a time No such feature is available in TIC, and while it can 
be impl 1 merited in Spectrum, it is difficult, and we have not done it <yet). 


To enter Terminal mode from the ProTerm scripts, you need to call the 
next item, Uuit Options . 


^ . . - r J S t iP0 s 7 Takes you to a menu that.allows you to Log off GEnie 

and return to LoPilot, Log off GEnie and stay in your comm program, or, if 
you are already off line, to quit back to Copilot (or whatever program you 
launched the comm program from). You can also recall the Copilot Menu 
from here. You ALoU have the option of running your own custom menu 
from here, (see Appendix 3 for more details). 


Copilot Special Action Menu 


This menu presents you with 5 choices of actions, any one you choose will 
be performed the next time you go on line. You also have an option to 
C ese ^ 4 . 5 ny °t actions, which simply calls the master 

♦delete/reset# script. The actions you can choose from here are 

1. Get the A2 version of GEnieLamp. 


2. Get the A2Pro version of GEnieLamp. 

3. Get the A2 4Disk of the Months 


4. Get the A2Pro ♦Blue Plate Special# 

5. Get your GEnie Bill. 


6 . Check/reset all actions. 


?. Return to Copilot Menu. 


fro E? Items 1-4 will be downloaded to the specified prefix for 
to the T GEFI^Is cJ?re<"tory° ne see ^elow), the GEBill file will be downloaded 


Note : Item 6 is just another way to get to the 

Item b on the main LoPilot Menu. 


‘check/reset” script that is 


Copilot Setup Menu 


1 |et RAM or BROwse- Allows you.to choose whether the action 

r 1 !* do a RAM (.read all marked) or BRuwse Cread all new messages 

in anu Lst, r TriD r. naf Kac nft+ Kaan 1 nr, r-. 1 1 1 .- r~. • « n.Ai • .. 


T *- 9 * r- ~ r-Z 2cdwdr rcu; or Dr_ ______ ... 

uPn a P= 4 -^ a i^°f« To ? that has.not been ignored, plus any new messages in any 
pIm £~ S K° r Tops). Browse is the default setting of the CoPilot action. 
RAM can be chosen tor any individual RT or for ALL RTs. 


Item 2- Set ^new files* list-.Allows you to set up a list of RTs in which 
you want to see the library.1ist^ot new uploads. <You will need the page 
numbers and the EXACT spelling ot the names ot the RTs as you have 

entered r.npw I r. unur fr.pi 1 rk + c*T<r lief ir. 4- k r«Di s t- _ . 


you do NOT set up such a list* this action will not be performed and your 
scripts will choke if you set #new files* OH. 

Item 3- Set §new files* on/pff- Creates or deletes the marker file that 
tells the CoPilot scripts whether you want to get a #new files* list. If this 
0N/ then Copilot will yet this list from all the selected RTs the 
rlKbT time you 90 online in any given day. If you have not gotten the new 
rriMpfcTc S i' - 1 5? a * 9 i y ? n R T in more than 38 days* then you will get the 
92P£ L !I E I*?* t ll ff m the library The Snew files* subroutine will break 
into the tile list after two minutes have passed* so don*t panic when you 
see this huge list start scrolling. It WILL stop* and everything will work 
properly when it does. 


every 
’ es as 


thIi\-h2I E ' i f y ou choose to download ALL.files to a specific folder* and 
4 -K 24 -^DT n i 1 i?i a i j fll ? s tr om jC > 3 , specific RT to a different folder* 
tile* from that RT WILL 90 to the folder you have chosen, tin other words* 
?6°sen for a specific RT.will over ride a prefix chosen for ALL 
+ set any prefix <and you don*t have to unless you feel 

like it) then all files will be downloaded to the GEFILES folder. 

th i s a specific prefix for Spectrum downloads* 

®i^h?!I ^wail or the library* does not work consistently. The script 

cum1i a n ds a f* corr ect* and have Been verified with Sevenhills. They 

Properly, but sometimes they don*t. We are trying to track 

scr?pt^avai?able*with the fix 1 ^ /w ^ en we it* we will make a modified 

i i spe ^fi ical i y " is that when this routine fails* the 
downloaded tile will qo to one ot three places* either the GEFILES 

your default download* directory as set in your Spectrum 
+ 2 9 ? Menu* or x h the directory level above the one you wanted the 
tile to go to. There is no apparent pattern for this failure* and the routine 
22 r K? prop ?rly MUbT ot the time. Some of the beta testers have had no 

t. a t all. )ou will not actually LOSE any files if you attempt 
i? wse this feature* but you MAY not be able €0 find them where you expect 
tnew to be. 

N°£® : When entering a pathname for Spectrum, you should use colons as 
delimiters in the pathname. When entering a pathname for TIC or ProTerm, 
slashes. In any case, you MUST terminate the pathname 
with a delimiter character or the pathname will be invalid. 

WARNING! If you enter an invalid pathname here (i.e. the name of a folder 
exis ^J or misspell a folder name, the dounload scripts WILL 
break, and the usual ugly things uill happen. 


Xmodem mail on-off- This refers to the AUTOMATIC 
2°“' n l2f d 42Srf2i Xmpdem Email. If it is set ON, you will, in the event that 
82XH2..£?? d ?5 I 3* ll i b S Presented with a dialog telling you that you have 
Xmodem mail to download* and giving you 18 seconds to cancel that action 
£E=E!^ s ?i n l a ?y.i?ey. If, you have it set to OFF, the dialog uill offer you the 
^napce to ♦get it now* by pressing any key within ten second. The default 

preference is U set e to°OFF 1 ^ in9 ^ ere watching) is to NOT dounload if this 


Item 6- Checkereset all actions- calls the same script to check ALL 
actions mentioned above. 


Item 7- Return to CoPilot Menu 


RoundTable Set up menu 
This menu is used for configurin 


121? rv Me f:if.. 1S i ¥? ed t 8 r 4 . co P fl 9 U PAC 9 -r?R e f lf 1C to y our own taste. Once 

?§l 1 9t y 2 u W11 /to know EXACTLY how you have spelled the name of 
£pe J*I , 1 ,P.. y 2 ur £I S in .the CoPilot program. Each of the items uill 

prompt you for the information it needs. 

Item 1- Ignore Categories and Topics- allows you to compose a list of 
Categories and Topics you want to ignore in any RT. 

Item 2- tancel Categories- permanently cancels your participation in an 
entire category 

t£ e Sark (for Il^f^thl"^ 0 command) UP a Hst ° f tOPiCS WhiCh y ° U Uant 


Item 4- Get an 
whatever RT you 
CRT name].INDEX 
print out the i 
mark, etc. The 
have currently 
However, you sh 
iou have cancel 
irectory with 


a 


Index or Topic List-. This will get an INDEX list of 
seiect and save it in the GEFILES directory with the name 
You should really do this before doing anything else* then 
dex a mark oft those topics you want to cancel* ignore* 

?^ d 0 P°llnSflS . a T|!;i P tip^ S tiS{ 1 iiV? T b| h |3^ri£ a ^l <> KPlLES 

the name CRT name!.Topics. 



Item 5- Set your RT Name- This allous you to set a nickname* or ♦handle®. 
Enter the name here* and when you 90 online* the scripts will put up the 
nickname in the chosen RT. 

Item 6- Check/reset all actions- calls the same script to check ALL 
actions mentioned above. 

Item 7- Return to Copilot Menu 



